home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
spitfire
/
sflst101.zip
/
SFLSTGEN.DOC
< prev
next >
Wrap
Text File
|
1991-10-12
|
14KB
|
327 lines
┌─────────────────────────────────────────────────────────────────────────────┐
│ ╒═════════════════════════════════════════╕ │
│ ┌──────────────┤ SF■File List & Bulletin Generator ├──────────────┐ │
│┌─┼─┐ ╘═════════════════════════════════════════╛ ┌─┼─┐│
││ └─┘ └─┘ ││
││ Version 1.01 ││
││ Public Release ││
││ ││
││ RelayNet ID:IVYTECH ││
││ ││
││ By: Philip K. Brown ││
││ ││
││ Brown Business Software ││
││ 243 South 24th Street ││
││ Terre Haute, Indiana 47803 ││
││ ││
││ ││
││ ││
││ ┌─┐ Support BBS: Ivy Tech's BBS (812) 299-9306 RIME ID:IVYTECH ┌─┐ ││
│└─┼─┘ The Saratoga BBS (812) 877-9161 US Robotics HST └─┼─┘│
│ └───────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
Introduction
This program is created for Spitfire Bulletin Boards Systems so users can
download a complete listing of all files available on his/her board. This
list will be available in 2 formats. One will be a .ZIP file and the other
will be an ASCII Text file with a .LST extension.
This program will also take the information used in creating the list to
create a File Area Statistics bulletin that will display the file area
description, file area number, directory size and total number of files in
each file area. After all file areas are displayed, a total will be
displayed at the bottom. This will be in 1 bulletin, With a .CLR (color) and
.BBS (black and white) placed in the Spitfire Display path.
Upon Registration
Once you have registered this program, you will receive a update that will
enable the following options:
- Disables the nag screen on the opening screen.
- Display your Bulletin Board Name on the File Area Statistics Bulletin.
- Display your Bulletin Board Name in the listing that was created.
- It will use your name instead of 'Unregistered Copy' when running this
as an event.
Warranty
This product is provided "as is" without warranty of any kind. The entire
risk as to the results and performance of the program is assumed by you.
Further more, I, the author, do not warranty, guarantee, or make any
representations regarding the use of, or the results of the use of the
program, and you rely on the program and results solely at your own risk. I,
the author, cannot accept responsibility for system damage, loss of profit, or any
other special, incidental, or consequential damages resulting from the use or
inability to use this product.
Copyright
File List & Bulletin Generator is to be distributed as SHAREWARE.
Under this concept you may use the SHAREWARE (unregistered) version for a
reasonable period of time, which I consider to be four weeks, after which you
must either register your copy or discontinue usage.
Distribution
You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
version of File List & Bulletin Generator provided that all files contained in the original File List archive are distributed in their
original, unmodified state.
The following files are required for the File List & Bulletin Generator:
- SFLSTGEN.EXE Executable Program
- SFLSTGEN.OVL Overlay File for SFLSTGEN.EXE
- SFLSTGEN.DOC Documentation (Currently Reading it)
- AREA2TXT.EXE Collects Spitfire File Area Information
(Called From SFLSTGEN.EXE)
The following file(s) are created the first time you run SFLSTGEN SETUP:
- SFLSTGEN.000 Data File - Information needed by SFLSTGEN.EXE
- SFLSTGEN.001 Data File - Used when reading SFFILES.BBS
- SFLSTGEN.002 Data File - Used in Creating Bulletin
- SFLSTGEN.003 Data File - File Area Information
The following file(s) are created & deleted during the execution of the
program. NOTE: You never see the files listed below unless their is an error.
- SFLSTGEN.PTH Data File - Used in collecting File Area Information
- SFLSTGEN.DSK Disk File - Used in saving memory to disk before
dropping to dos to perform the PKZIP or
reading SFFAREA.DAT. When the 2 tasks are
completed memory is restored.
The following file is created if a 'Disk Full' Error is encountered:
- ERROR.LOG This LOG file reports any 'Disk Full' Errors.
----- Features of File List & Bulletin Generator -----
- Runs on Spitfire Bulletin Boards Version 2.8 to 3.xx!
- Need Help? Type SFLSTGEN HELP and a brief help window is displayed.
- Ease of Configuring! Type SFLSTGEN SETUP and follow the prompts..
- Creates both .BBS & .CLR Bulletins.
- Lets you pick what Directory you want to put your Lists in.
- Lets you pick what file areas you want to add to the list.
- CD-ROM Support.
- Works well in a multi-node environment.
****** Setting Up File List ******
You will need to create a directory you wish to run this program from. I
suggest C:\SF\SFLSTGEN or something similar, after it's created, then change
to that directory, and then unzip the SFLST101.ZIP into that directory.
When thats done, you must type SFLSTGEN SETUP then it will display a screen
with some options for you to fill in. If you make a mistake, just use you
arrow keys to move to the line and make the correction.
The first line is for your Bulletin Board name. This is only available upon
your registration.
When you have filled in all the blanks, just press enter and it will ask you
if the above information is correct. If not, then please press "N" and make
the appropriate changes. When the above information is correct answer "Y"
the next question it will ask is "Have you made any changes in the File Area
Section.". Please answer "Y" to this question.
This will allow you to select the File Areas you want to include in this
Complete File Listing.
Using the "" (Up) and "" (Down) keys, you can browse thru the File Areas.
If you see a File Area you don't want to include in the list, press the
Spacebar; it will put "Don't Use" in a box on the line above. If you decide
you want that File Area then press the Spacebar again to unselect it.
When you come to the area you want your Zip and Text file to be placed, press
the Insert Key and "Put Zip Here" is placed in the second box on your screen.
If you make a mistake press the Insert key a second time to remove your
selection. Remember, this list can only go to one File Area. Please make
sure you select the right area.
If you have a CD-ROM setup on your board then as you are browsing thru the
file areas and one is a CD-ROM area then the words "CD-ROM" will appear in the
third box on the line above.
This is done automatically for you. All CD-ROM areas will check the DISPLAY
directory for the individual SFFILES.<File Area Number>.
When you have selected everything you need, press enter <Enter> or Return to
save your corrections. This will return you to the DOS prompt.
The next step is setting up an Event for this program to run under.
Using your favorite Text Editor, you will need to edit SF.BAT in your
Spitfire System directory usually C:\SF.
Listed below are 2 examples you can use to create your event:
NOTE: The following examples assume your Spitfire directory is C:\SF and you
have placed the files in a directory called SFLSTGEN off of your C:\SF
directory. ie. C:\SF\SFLSTGEN
If your system does not support ANSI color graphics then use the
following line when running this event.
Replace "SFLSTGEN COLOR" with "SFLSTGEN MONO"
--- Sample Batch File For Normal Setup ---
:EVENT_K
REM Spitfire's SF■File List & Bulletin Generator
CD C:\SF\SFLSTGEN
SFLSTGEN COLOR
CD C:\SF
GOTO LOOP
--- Sample Batch File For Multi-Node ---
If yours is a multi-node board, use the following commands.
(SFBUSY.COM is shareware available from Buffalo Creek Software.)
This usage has been tested on multi-node Spitfire board.
:EVENT_K
REM Spitfire's SF■File List & Bulletin Generator
CD C:\SF\SFLSTGEN
SFBUSY C:\SF\WORK /S
IF ERRORLEVEL 2 GOTO EVENT_K
IF ERRORLEVEL 1 GOTO K_END
SFLSTGEN COLOR
SFBUSY C:\SF\WORK /C
:K_END
CD C:\SF
GOTO LOOP
After you have added the Event to SF.BAT you must Enable the Event within
Spitfire. Please refer to the Spitfire Manual for assistance.
NOTE: If this program has a Disk Full Error then a ERROR.LOG is created
and pauses a moment on the screen and then returns to DOS or to your
next event.
This program has not been tested on Networking (Lan environment).
This program may not work Dropped to DOS via Spitfire! Insufficient
memory.
Please make sure PKZIP is in your DOS path.
====== Support == Support == Support == Support == Support == Support =======
If you have any problems, find any bugs, just have an idea; please feel free
to contact me. Listed below are a two ways to do so.
Call the following Bulletin Boards:
Ivy Tech's BBS (812) 299-9306 19200/9600/2400/1200 Baud
The Saratoga BBS (812) 877-9161 19200/9600/2400/1200 Baud
If you are a member of RIME, you can leave me a message in any of
the Spitfire Conferences, or in the COMMON Conference and you can route
the message to me at Ivy Tech's BBS by placing a ->IVYTECH on the
first line of the message and sending it to Philip Brown.
If you are a Registered Sysop, all new updates will be available to you.
However, you must Download them or pay for postage, but I will mail the
first Registered Copy to you.
====== Support == Support == Support == Support == Support == Support =======
Something That Needs To Be Said
I would like to thank Richard Heckelsberg for the help and ideas he gave me
while writing this program and for standing by me while I used his Bulletin
Board for testing. Not many people would allow you to do that.
I would like to thank my Dad, Donald Brown for his help in general and
starting a Computer Consulting Company. Brown Business Software.
I would like to thank Mike Woltz for creating Spitfire Bulletin Board
Software. Without it this program would not have been.
This program is written using Clipper, a dBASE Compiler. Many thanks to
Doug Stevens and Larry Taylor, two instructors who taught dbase II and
Advanced dBASE III+.
Copyright, Trademark and Service Mark Notices
CLIPPER is a trademark of Nantucket Corporation
NANTUCKET is a registered trademark of Nantucket Corporation
SPITFIRE is Copyright (c) 1987-1991 by Mike Woltz
SPITFIRE is a registered trademark of Buffalo Creek Software.
PKZIP is a Copyright (c) 1989-1990 PKWARE Inc. All Rights Reserved.
SWAP is a Copyright (c) 1988-1991 by Berner & Associates.
***** Registration *****
Mail to: Brown Business Software
c/o Philip K. Brown
243 South 24th Street
Terre Haute, Indiana 47803
Your Name______________________________________________________
Street Address______________________________________________________
City______________________________________________________
State, Zip______________________________________________________
Home Phone#______________________________________________________
BBS Name___________________________________________________________
BBS Hours____________________ /Baud Rate___________________________
BBS Phone#_________________________________________________________
BBS Software_______________________________________________________
Are you a Member of RIME?_________ If Yes, What is you ID:________
Disk Format (Check one) 5 1/4 (360k) _____ 3 1/2 (720k) _____
Please send a Bank draft/money order or Postal Money order for $15.00 to
the address on the top of this form. If you must send a Personal check,
this will cause a 2-3 week delay in processing. THANK YOU for registering.
It will encourage me to write more Programs in the future.
Ivy Tech's BBS The Saratoga BBS
Philip Brown, SysOp Rick Heckelsberg, SysOp
(812) 299-9306 (812) 877-9161 - 2 Node's
19200/9600/2400/1200 Baud 19200/9600/2400/1200 Baud